<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkContainer</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 参考手册">
<link rel="up" href="AbstractObjects.html" title="抽象基类">
<link rel="prev" href="gtk3-GtkWidget.html" title="GtkWidget">
<link rel="next" href="gtk3-GtkBin.html" title="GtkBin">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gtk3-GtkWidget.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="AbstractObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 参考手册</th>
<td><a accesskey="n" href="gtk3-GtkBin.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk3-GtkContainer.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gtk3-GtkContainer.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gtk3-GtkContainer"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkContainer.top_of_page"></a>GtkContainer</span></h2>
<p>GtkContainer — Base class for widgets which contain other widgets</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk3-GtkContainer.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer">GtkContainer</a>;
#define             <a class="link" href="gtk3-GtkContainer.html#GTK-IS-RESIZE-CONTAINER:CAPS" title="GTK_IS_RESIZE_CONTAINER()">GTK_IS_RESIZE_CONTAINER</a>             (widget)
#define             <a class="link" href="gtk3-GtkContainer.html#GTK-CONTAINER-WARN-INVALID-CHILD-PROPERTY-ID:CAPS" title="GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID()">GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID</a>(object,
                                                         property_id,
                                                         pspec)
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-add" title="gtk_container_add ()">gtk_container_add</a>                   (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()">gtk_container_remove</a>                (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-add-with-properties" title="gtk_container_add_with_properties ()">gtk_container_add_with_properties</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<a class="link" href="gtk3-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="returnvalue">GtkResizeMode</span></a>       <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-resize-mode" title="gtk_container_get_resize_mode ()">gtk_container_get_resize_mode</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-resize-mode" title="gtk_container_set_resize_mode ()">gtk_container_set_resize_mode</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="type">GtkResizeMode</span></a> resize_mode</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-check-resize" title="gtk_container_check_resize ()">gtk_container_check_resize</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()">gtk_container_foreach</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-children" title="gtk_container_get_children ()">gtk_container_get_children</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<a class="link" href="gtk3-GtkWidgetPath.html#GtkWidgetPath" title="GtkWidgetPath"><span class="returnvalue">GtkWidgetPath</span></a> *     <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-path-for-child" title="gtk_container_get_path_for_child ()">gtk_container_get_path_for_child</a>    (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-reallocate-redraws" title="gtk_container_set_reallocate_redraws ()">gtk_container_set_reallocate_redraws</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> needs_redraws</code></em>);
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-focus-child" title="gtk_container_get_focus_child ()">gtk_container_get_focus_child</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-child" title="gtk_container_set_focus_child ()">gtk_container_set_focus_child</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);
<a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-focus-vadjustment" title="gtk_container_get_focus_vadjustment ()">gtk_container_get_focus_vadjustment</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-vadjustment" title="gtk_container_set_focus_vadjustment ()">gtk_container_set_focus_vadjustment</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);
<a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-focus-hadjustment" title="gtk_container_get_focus_hadjustment ()">gtk_container_get_focus_hadjustment</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-hadjustment" title="gtk_container_set_focus_hadjustment ()">gtk_container_set_focus_hadjustment</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-resize-children" title="gtk_container_resize_children ()">gtk_container_resize_children</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<a href="../gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-type" title="gtk_container_child_type ()">gtk_container_child_type</a>            (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-get" title="gtk_container_child_get ()">gtk_container_child_get</a>             (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-set" title="gtk_container_child_set ()">gtk_container_child_set</a>             (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-get-property" title="gtk_container_child_get_property ()">gtk_container_child_get_property</a>    (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-set-property" title="gtk_container_child_set_property ()">gtk_container_child_set_property</a>    (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
                                                         <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-get-valist" title="gtk_container_child_get_valist ()">gtk_container_child_get_valist</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-set-valist" title="gtk_container_child_set_valist ()">gtk_container_child_set_valist</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()">gtk_container_forall</a>                (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);
<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-border-width" title="gtk_container_get_border_width ()">gtk_container_get_border_width</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-border-width" title="gtk_container_set_border_width ()">gtk_container_set_border_width</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> border_width</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-propagate-draw" title="gtk_container_propagate_draw ()">gtk_container_propagate_draw</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code><a href="../cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkContainer.html#gtk-container-get-focus-chain" title="gtk_container_get_focus_chain ()">gtk_container_get_focus_chain</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **focusable_widgets</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-chain" title="gtk_container_set_focus_chain ()">gtk_container_set_focus_chain</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *focusable_widgets</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-unset-focus-chain" title="gtk_container_unset_focus_chain ()">gtk_container_unset_focus_chain</a>     (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
<a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *        <a class="link" href="gtk3-GtkContainer.html#gtk-container-class-find-child-property" title="gtk_container_class_find_child_property ()">gtk_container_class_find_child_property</a>
                                                        (<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-class-install-child-property" title="gtk_container_class_install_child_property ()">gtk_container_class_install_child_property</a>
                                                        (<em class="parameter"><code><span class="type">GtkContainerClass</span> *cclass</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);
<a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **       <a class="link" href="gtk3-GtkContainer.html#gtk-container-class-list-child-properties" title="gtk_container_class_list_child_properties ()">gtk_container_class_list_child_properties</a>
                                                        (<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkContainer.html#gtk-container-class-handle-border-width" title="gtk_container_class_handle_border_width ()">gtk_container_class_handle_border_width</a>
                                                        (<em class="parameter"><code><span class="type">GtkContainerClass</span> *klass</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkContainer.description"></a><h2>Description</h2>
<p>
A GTK+ user interface is constructed by nesting widgets inside widgets.
Container widgets are the inner nodes in the resulting tree of widgets:
they contain other widgets. So, for example, you might have a <a class="link" href="gtk3-GtkWindow.html#GtkWindow" title="GtkWindow"><span class="type">GtkWindow</span></a>
containing a <a class="link" href="gtk3-GtkFrame.html#GtkFrame" title="struct GtkFrame"><span class="type">GtkFrame</span></a> containing a <a class="link" href="gtk3-GtkLabel.html#GtkLabel" title="struct GtkLabel"><span class="type">GtkLabel</span></a>. If you wanted an image instead
of a textual label inside the frame, you might replace the <a class="link" href="gtk3-GtkLabel.html#GtkLabel" title="struct GtkLabel"><span class="type">GtkLabel</span></a> widget
with a <a class="link" href="gtk3-GtkImage.html#GtkImage" title="struct GtkImage"><span class="type">GtkImage</span></a> widget.
</p>
<p>
There are two major kinds of container widgets in GTK+. Both are subclasses
of the abstract GtkContainer base class.
</p>
<p>
The first type of container widget has a single child widget and derives
from <a class="link" href="gtk3-GtkBin.html#GtkBin" title="struct GtkBin"><span class="type">GtkBin</span></a>. These containers are <span class="emphasis"><em>decorators</em></span>, which
add some kind of functionality to the child. For example, a <a class="link" href="gtk3-GtkButton.html#GtkButton" title="struct GtkButton"><span class="type">GtkButton</span></a> makes
its child into a clickable button; a <a class="link" href="gtk3-GtkFrame.html#GtkFrame" title="struct GtkFrame"><span class="type">GtkFrame</span></a> draws a frame around its child
and a <a class="link" href="gtk3-GtkWindow.html#GtkWindow" title="GtkWindow"><span class="type">GtkWindow</span></a> places its child widget inside a top-level window.
</p>
<p>
The second type of container can have more than one child; its purpose is to
manage <span class="emphasis"><em>layout</em></span>. This means that these containers assign
sizes and positions to their children. For example, a <a class="link" href="gtk3-GtkHBox.html#GtkHBox" title="struct GtkHBox"><span class="type">GtkHBox</span></a> arranges its
children in a horizontal row, and a <a class="link" href="gtk3-GtkTable.html#GtkTable" title="struct GtkTable"><span class="type">GtkTable</span></a> arranges the widgets it contains
in a two-dimensional grid.
</p>
<p>
</p>
<div class="refsect2">
<a name="container-geometry-management"></a><h3>Height for width geometry management</h3>
<p>
GTK+ uses a height-for-width (and width-for-height) geometry management system.
Height-for-width means that a widget can change how much vertical space it needs,
depending on the amount of horizontal space that it is given (and similar for
width-for-height).
</p>
<p>
There are some things to keep in mind when implementing container widgets
that make use of GTK+'s height for width geometry management system. First,
it's important to note that a container must prioritize one of its
dimensions, that is to say that a widget or container can only have a
<a class="link" href="gtk3-GtkWidget.html#GtkSizeRequestMode" title="enum GtkSizeRequestMode"><span class="type">GtkSizeRequestMode</span></a> that is <a class="link" href="gtk3-GtkWidget.html#GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS"><code class="literal">GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</code></a> or
<a class="link" href="gtk3-GtkWidget.html#GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><code class="literal">GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</code></a>. However, every widget and container
must be able to respond to the APIs for both dimensions, i.e. even if a
widget has a request mode that is height-for-width, it is possible that
its parent will request its sizes using the width-for-height APIs.
</p>
<p>
To ensure that everything works properly, here are some guidelines to follow
when implementing height-for-width (or width-for-height) containers.
</p>
<p>
Each request mode involves 2 virtual methods. Height-for-width apis run
through <a class="link" href="gtk3-GtkWidget.html#gtk-widget-get-preferred-width" title="gtk_widget_get_preferred_width ()"><code class="function">gtk_widget_get_preferred_width()</code></a> and then through <a class="link" href="gtk3-GtkWidget.html#gtk-widget-get-preferred-height-for-width" title="gtk_widget_get_preferred_height_for_width ()"><code class="function">gtk_widget_get_preferred_height_for_width()</code></a>.
When handling requests in the opposite <a class="link" href="gtk3-GtkWidget.html#GtkSizeRequestMode" title="enum GtkSizeRequestMode"><span class="type">GtkSizeRequestMode</span></a> it is important that
every widget request at least enough space to display all of its content at all times.
</p>
<p>
When <a class="link" href="gtk3-GtkWidget.html#gtk-widget-get-preferred-height" title="gtk_widget_get_preferred_height ()"><code class="function">gtk_widget_get_preferred_height()</code></a> is called on a container that is height-for-width,
the container must return the height for its minimum width. This is easily achieved by
simply calling the reverse apis implemented for itself as follows:
</p>
<p>
</p>
<pre class="programlisting">
static void
foo_container_get_preferred_height (GtkWidget *widget, gint *min_height, gint *nat_height)
{
   if (i_am_in_height_for_width_mode)
     {
       gint min_width;

       GTK_WIDGET_GET_CLASS (widget)-&gt;get_preferred_width (widget, &amp;min_width, NULL);
       GTK_WIDGET_GET_CLASS (widget)-&gt;get_preferred_height_for_width (widget, min_width,
                                                                      min_height, nat_height);
     }
   else
     {
       ... many containers support both request modes, execute the real width-for-height
       request here by returning the collective heights of all widgets that are
       stacked vertically (or whatever is appropriate for this container) ...
     }
}
</pre>
<p>
</p>
<p>
Similarly, when <a class="link" href="gtk3-GtkWidget.html#gtk-widget-get-preferred-width-for-height" title="gtk_widget_get_preferred_width_for_height ()"><code class="function">gtk_widget_get_preferred_width_for_height()</code></a> is called for a container or widget
that is height-for-width, it then only needs to return the base minimum width like so:
</p>
<p>
</p>
<pre class="programlisting">
static void
foo_container_get_preferred_width_for_height (GtkWidget *widget, gint for_height,
                                              gint *min_width, gint *nat_width)
{
   if (i_am_in_height_for_width_mode)
     {
       GTK_WIDGET_GET_CLASS (widget)-&gt;get_preferred_width (widget, min_width, nat_width);
     }
   else
     {
       ... execute the real width-for-height request here based on the required width
       of the children collectively if the container were to be allocated the said height ...
     }
}
</pre>
<p>
</p>
<p>
Height for width requests are generally implemented in terms of a virtual allocation
of widgets in the input orientation. Assuming an height-for-width request mode, a container
would implement the <code class="function"><code class="function">get_preferred_height_for_width()</code></code> virtual function by first calling
<a class="link" href="gtk3-GtkWidget.html#gtk-widget-get-preferred-width" title="gtk_widget_get_preferred_width ()"><code class="function">gtk_widget_get_preferred_width()</code></a> for each of its children.
</p>
<p>
For each potential group of children that are lined up horizontally, the values returned by
<a class="link" href="gtk3-GtkWidget.html#gtk-widget-get-preferred-width" title="gtk_widget_get_preferred_width ()"><code class="function">gtk_widget_get_preferred_width()</code></a> should be collected in an array of <a class="link" href="gtk3-GtkWidget.html#GtkRequestedSize" title="struct GtkRequestedSize"><span class="type">GtkRequestedSize</span></a> structures.
Any child spacing should be removed from the input <em class="parameter"><code>for_width</code></em> and then the collective size should be
allocated using the <a class="link" href="gtk3-GtkWidget.html#gtk-distribute-natural-allocation" title="gtk_distribute_natural_allocation ()"><code class="function">gtk_distribute_natural_allocation()</code></a> convenience function.
</p>
<p>
The container will then move on to request the preferred height for each child by using
<a class="link" href="gtk3-GtkWidget.html#gtk-widget-get-preferred-height-for-width" title="gtk_widget_get_preferred_height_for_width ()"><code class="function">gtk_widget_get_preferred_height_for_width()</code></a> and using the sizes stored in the <a class="link" href="gtk3-GtkWidget.html#GtkRequestedSize" title="struct GtkRequestedSize"><span class="type">GtkRequestedSize</span></a> array.
</p>
<p>
To allocate a height-for-width container, it's again important
to consider that a container must prioritize one dimension over the other. So if
a container is a height-for-width container it must first allocate all widgets horizontally
using a <a class="link" href="gtk3-GtkWidget.html#GtkRequestedSize" title="struct GtkRequestedSize"><span class="type">GtkRequestedSize</span></a> array and <a class="link" href="gtk3-GtkWidget.html#gtk-distribute-natural-allocation" title="gtk_distribute_natural_allocation ()"><code class="function">gtk_distribute_natural_allocation()</code></a> and then add any
extra space (if and where appropriate) for the widget to expand.
</p>
<p>
After adding all the expand space, the container assumes it was allocated sufficient
height to fit all of its content. At this time, the container must use the total horizontal sizes
of each widget to request the height-for-width of each of its children and store the requests in a
<a class="link" href="gtk3-GtkWidget.html#GtkRequestedSize" title="struct GtkRequestedSize"><span class="type">GtkRequestedSize</span></a> array for any widgets that stack vertically (for tabular containers this can
be generalized into the heights and widths of rows and columns).
The vertical space must then again be distributed using <a class="link" href="gtk3-GtkWidget.html#gtk-distribute-natural-allocation" title="gtk_distribute_natural_allocation ()"><code class="function">gtk_distribute_natural_allocation()</code></a>
while this time considering the allocated height of the widget minus any vertical spacing
that the container adds. Then vertical expand space should be added where appropriate and available
and the container should go on to actually allocating the child widgets.
</p>
<p>
See <a class="link" href="gtk3-GtkWidget.html#geometry-management" title="Height-for-width Geometry Management">GtkWidget's geometry management section</a>
to learn more about implementing height-for-width geometry management for widgets.
</p>
</div>
<p>
</p>
<hr>
<div class="refsect2">
<a name="child-properties"></a><h3>Child properties</h3>
<p>
GtkContainer introduces <span class="emphasis"><em>child properties</em></span>.
These are object properties that are not specific
to either the container or the contained widget, but rather to their relation.
Typical examples of child properties are the position or pack-type of a widget
which is contained in a <a class="link" href="gtk3-GtkBox.html#GtkBox" title="struct GtkBox"><span class="type">GtkBox</span></a>.
</p>
<p>
Use <a class="link" href="gtk3-GtkContainer.html#gtk-container-class-install-child-property" title="gtk_container_class_install_child_property ()"><code class="function">gtk_container_class_install_child_property()</code></a> to install child properties
for a container class and <a class="link" href="gtk3-GtkContainer.html#gtk-container-class-find-child-property" title="gtk_container_class_find_child_property ()"><code class="function">gtk_container_class_find_child_property()</code></a> or
<a class="link" href="gtk3-GtkContainer.html#gtk-container-class-list-child-properties" title="gtk_container_class_list_child_properties ()"><code class="function">gtk_container_class_list_child_properties()</code></a> to get information about existing
child properties.
</p>
<p>
To set the value of a child property, use <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-set-property" title="gtk_container_child_set_property ()"><code class="function">gtk_container_child_set_property()</code></a>,
<a class="link" href="gtk3-GtkContainer.html#gtk-container-child-set" title="gtk_container_child_set ()"><code class="function">gtk_container_child_set()</code></a> or <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-set-valist" title="gtk_container_child_set_valist ()"><code class="function">gtk_container_child_set_valist()</code></a>.
To obtain the value of a child property, use
<a class="link" href="gtk3-GtkContainer.html#gtk-container-child-get-property" title="gtk_container_child_get_property ()"><code class="function">gtk_container_child_get_property()</code></a>, <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-get" title="gtk_container_child_get ()"><code class="function">gtk_container_child_get()</code></a> or
<a class="link" href="gtk3-GtkContainer.html#gtk-container-child-get-valist" title="gtk_container_child_get_valist ()"><code class="function">gtk_container_child_get_valist()</code></a>. To emit notification about child property
changes, use <a class="link" href="gtk3-GtkWidget.html#gtk-widget-child-notify" title="gtk_widget_child_notify ()"><code class="function">gtk_widget_child_notify()</code></a>.
</p>
</div>
<p>
</p>
<hr>
<div class="refsect2">
<a name="GtkContainer-BUILDER-UI"></a><h3>GtkContainer as GtkBuildable</h3>
<p>
The GtkContainer implementation of the GtkBuildable interface
supports a &lt;packing&gt; element for children, which can
contain multiple &lt;property&gt; elements that specify
child properties for the child.
</p>
<div class="example">
<a name="id3847088"></a><p class="title"><b>Example 86. Child properties in UI definitions</b></p>
<div class="example-contents"><pre class="programlisting">
&lt;object class="GtkVBox"&gt;
  &lt;child&gt;
    &lt;object class="GtkLabel"/&gt;
    &lt;packing&gt;
      &lt;property name="pack-type"&gt;start&lt;/property&gt;
    &lt;/packing&gt;
  &lt;/child&gt;
&lt;/object&gt;
</pre></div>
</div>
<p><br class="example-break">
Since 2.16, child properties can also be marked as translatable using
the same "translatable", "comments" and "context" attributes that are used
for regular properties.
</p>
</div>
<p>
</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkContainer.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkContainer"></a><h3>struct GtkContainer</h3>
<pre class="programlisting">struct GtkContainer {
  GtkWidget widget;
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GTK-IS-RESIZE-CONTAINER:CAPS"></a><h3>GTK_IS_RESIZE_CONTAINER()</h3>
<pre class="programlisting">#define             GTK_IS_RESIZE_CONTAINER(widget)</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GTK-CONTAINER-WARN-INVALID-CHILD-PROPERTY-ID:CAPS"></a><h3>GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID()</h3>
<pre class="programlisting">#define             GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID(object, property_id, pspec)</pre>
<p>
This macro should be used to emit a standard warning about unexpected
properties in <code class="function">set_child_property()</code> and <code class="function">get_child_property()</code> implementations.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
<td>the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> on which <code class="function">set_child_property()</code> or <code class="function">get_child_property()</code>
was called</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>property_id</code></em> :</span></p></td>
<td>the numeric id of the property</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
<td>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the property</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-add"></a><h3>gtk_container_add ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_add                   (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
<p>
Adds <em class="parameter"><code>widget</code></em> to <em class="parameter"><code>container</code></em>. Typically used for simple containers
such as <a class="link" href="gtk3-GtkWindow.html#GtkWindow" title="GtkWindow"><span class="type">GtkWindow</span></a>, <a class="link" href="gtk3-GtkFrame.html#GtkFrame" title="struct GtkFrame"><span class="type">GtkFrame</span></a>, or <a class="link" href="gtk3-GtkButton.html#GtkButton" title="struct GtkButton"><span class="type">GtkButton</span></a>; for more complicated
layout containers such as <a class="link" href="gtk3-GtkBox.html#GtkBox" title="struct GtkBox"><span class="type">GtkBox</span></a> or <a class="link" href="gtk3-GtkTable.html#GtkTable" title="struct GtkTable"><span class="type">GtkTable</span></a>, this function will
pick default packing parameters that may not be correct.  So
consider functions such as <a class="link" href="gtk3-GtkBox.html#gtk-box-pack-start" title="gtk_box_pack_start ()"><code class="function">gtk_box_pack_start()</code></a> and
<a class="link" href="gtk3-GtkTable.html#gtk-table-attach" title="gtk_table_attach ()"><code class="function">gtk_table_attach()</code></a> as an alternative to <a class="link" href="gtk3-GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> in
those cases. A widget may be added to only one container at a time;
you can't place the same widget inside two different containers.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a widget to be placed inside <em class="parameter"><code>container</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-remove"></a><h3>gtk_container_remove ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_remove                (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
<p>
Removes <em class="parameter"><code>widget</code></em> from <em class="parameter"><code>container</code></em>. <em class="parameter"><code>widget</code></em> must be inside <em class="parameter"><code>container</code></em>.
Note that <em class="parameter"><code>container</code></em> will own a reference to <em class="parameter"><code>widget</code></em>, and that this
may be the last reference held; so removing a widget from its
container can destroy that widget. If you want to use <em class="parameter"><code>widget</code></em>
again, you need to add a reference to it while it's not inside
a container, using <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>. If you don't want to use <em class="parameter"><code>widget</code></em>
again it's usually more efficient to simply destroy it directly
using <a class="link" href="gtk3-GtkWidget.html#gtk-widget-destroy" title="gtk_widget_destroy ()"><code class="function">gtk_widget_destroy()</code></a> since this will remove it from the
container and help break any circular reference count cycles.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a current child of <em class="parameter"><code>container</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-add-with-properties"></a><h3>gtk_container_add_with_properties ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_add_with_properties   (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Adds <em class="parameter"><code>widget</code></em> to <em class="parameter"><code>container</code></em>, setting child properties at the same time.
See <a class="link" href="gtk3-GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> and <a class="link" href="gtk3-GtkContainer.html#gtk-container-child-set" title="gtk_container_child_set ()"><code class="function">gtk_container_child_set()</code></a> for more details.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a widget to be placed inside <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_prop_name</code></em> :</span></p></td>
<td>the name of the first child property to set</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-resize-mode"></a><h3>gtk_container_get_resize_mode ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="returnvalue">GtkResizeMode</span></a>       gtk_container_get_resize_mode       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Returns the resize mode for the container. See
<a class="link" href="gtk3-GtkContainer.html#gtk-container-set-resize-mode" title="gtk_container_set_resize_mode ()"><code class="function">gtk_container_set_resize_mode()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the current resize mode</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-resize-mode"></a><h3>gtk_container_set_resize_mode ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_resize_mode       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="type">GtkResizeMode</span></a> resize_mode</code></em>);</pre>
<p>
Sets the resize mode for the container.
</p>
<p>
The resize mode of a container determines whether a resize request
will be passed to the container's parent, queued for later execution
or executed immediately.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>resize_mode</code></em> :</span></p></td>
<td>the new resize mode</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-check-resize"></a><h3>gtk_container_check_resize ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_check_resize          (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-foreach"></a><h3>gtk_container_foreach ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_foreach               (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
<p>
Invokes <em class="parameter"><code>callback</code></em> on each non-internal child of <em class="parameter"><code>container</code></em>. See
<a class="link" href="gtk3-GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a> for details on what constitutes an
"internal" child.  Most applications should use
<a class="link" href="gtk3-GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()"><code class="function">gtk_container_foreach()</code></a>, rather than <a class="link" href="gtk3-GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>a callback. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
<td>callback user data</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-children"></a><h3>gtk_container_get_children ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gtk_container_get_children          (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Returns the container's non-internal children. See
<a class="link" href="gtk3-GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a> for details on what constitutes an "internal" child.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a newly-allocated list of the container's non-internal children. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-path-for-child"></a><h3>gtk_container_get_path_for_child ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidgetPath.html#GtkWidgetPath" title="GtkWidgetPath"><span class="returnvalue">GtkWidgetPath</span></a> *     gtk_container_get_path_for_child    (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>
Returns a newly created widget path representing all the widget hierarchy
from the toplevel down to <em class="parameter"><code>child</code></em> (this one not being included).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A newly created <a class="link" href="gtk3-GtkWidgetPath.html#GtkWidgetPath" title="GtkWidgetPath"><span class="type">GtkWidgetPath</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-reallocate-redraws"></a><h3>gtk_container_set_reallocate_redraws ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_reallocate_redraws
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> needs_redraws</code></em>);</pre>
<p>
Sets the <em class="parameter"><code>reallocate_redraws</code></em> flag of the container to the given value.
</p>
<p>
Containers requesting reallocation redraws get automatically
redrawn if any of their children changed allocation.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>needs_redraws</code></em> :</span></p></td>
<td>the new value for the container's <em class="parameter"><code>reallocate_redraws</code></em> flag</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-child"></a><h3>gtk_container_get_focus_child ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_container_get_focus_child       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Returns the current focus child widget inside <em class="parameter"><code>container</code></em>. This is not the
currently focused widget. That can be obtained by calling
<a class="link" href="gtk3-GtkWindow.html#gtk-window-get-focus" title="gtk_window_get_focus ()"><code class="function">gtk_window_get_focus()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The child widget which will receive the
focus inside <em class="parameter"><code>container</code></em> when the <em class="parameter"><code>conatiner</code></em> is focussed,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none is set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-child"></a><h3>gtk_container_set_focus_child ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_focus_child       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>
Sets, or unsets if <em class="parameter"><code>child</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the focused child of <em class="parameter"><code>container</code></em>.
</p>
<p>
This function emits the GtkContainer::set_focus_child signal of
<em class="parameter"><code>container</code></em>. Implementations of <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> can override the
default behaviour by overriding the class closure of this signal.
</p>
<p>
This is function is mostly meant to be used by widgets. Applications can use
<a class="link" href="gtk3-GtkWidget.html#gtk-widget-grab-focus" title="gtk_widget_grab_focus ()"><code class="function">gtk_widget_grab_focus()</code></a> to manualy set the focus to a specific widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-vadjustment"></a><h3>gtk_container_get_focus_vadjustment ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     gtk_container_get_focus_vadjustment (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Retrieves the vertical focus adjustment for the container. See
<a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-vadjustment" title="gtk_container_set_focus_vadjustment ()"><code class="function">gtk_container_set_focus_vadjustment()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the vertical focus adjustment, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
none has been set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-vadjustment"></a><h3>gtk_container_set_focus_vadjustment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_focus_vadjustment (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre>
<p>
Hooks up an adjustment to focus handling in a container, so when a
child of the container is focused, the adjustment is scrolled to
show that widget. This function sets the vertical alignment. See
<a class="link" href="gtk3-GtkScrolledWindow.html#gtk-scrolled-window-get-vadjustment" title="gtk_scrolled_window_get_vadjustment ()"><code class="function">gtk_scrolled_window_get_vadjustment()</code></a> for a typical way of obtaining
the adjustment and <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-hadjustment" title="gtk_container_set_focus_hadjustment ()"><code class="function">gtk_container_set_focus_hadjustment()</code></a> for setting
the horizontal adjustment.
</p>
<p>
The adjustments have to be in pixel units and in the same coordinate
system as the allocation for immediate children of the container.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td>
<td>an adjustment which should be adjusted when the focus
is moved among the descendents of <em class="parameter"><code>container</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-hadjustment"></a><h3>gtk_container_get_focus_hadjustment ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     gtk_container_get_focus_hadjustment (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Retrieves the horizontal focus adjustment for the container. See
<a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-hadjustment" title="gtk_container_set_focus_hadjustment ()"><code class="function">gtk_container_set_focus_hadjustment()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the horizontal focus adjustment, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
none has been set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-hadjustment"></a><h3>gtk_container_set_focus_hadjustment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_focus_hadjustment (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkAdjustment.html#GtkAdjustment" title="struct GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre>
<p>
Hooks up an adjustment to focus handling in a container, so when a child
of the container is focused, the adjustment is scrolled to show that
widget. This function sets the horizontal alignment.
See <a class="link" href="gtk3-GtkScrolledWindow.html#gtk-scrolled-window-get-hadjustment" title="gtk_scrolled_window_get_hadjustment ()"><code class="function">gtk_scrolled_window_get_hadjustment()</code></a> for a typical way of obtaining
the adjustment and <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-vadjustment" title="gtk_container_set_focus_vadjustment ()"><code class="function">gtk_container_set_focus_vadjustment()</code></a> for setting
the vertical adjustment.
</p>
<p>
The adjustments have to be in pixel units and in the same coordinate
system as the allocation for immediate children of the container.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td>
<td>an adjustment which should be adjusted when the focus is
moved among the descendents of <em class="parameter"><code>container</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-resize-children"></a><h3>gtk_container_resize_children ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_resize_children       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-type"></a><h3>gtk_container_child_type ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               gtk_container_child_type            (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Returns the type of the children supported by the container.
</p>
<p>
Note that this may return <a href="../gobject/gobject-Type-Information.html#G-TYPE-NONE:CAPS"><code class="literal">G_TYPE_NONE</code></a> to indicate that no more
children can be added, e.g. for a <a class="link" href="gtk3-GtkPaned.html#GtkPaned" title="struct GtkPaned"><span class="type">GtkPaned</span></a> which already has two
children.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-get"></a><h3>gtk_container_child_get ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_get             (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Gets the values of one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a widget which is a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_prop_name</code></em> :</span></p></td>
<td>the name of the first property to get</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-set"></a><h3>gtk_container_child_set ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_set             (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Sets one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a widget which is a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_prop_name</code></em> :</span></p></td>
<td>the name of the first property to set</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-get-property"></a><h3>gtk_container_child_get_property ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_get_property    (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<p>
Gets the value of a child property for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a widget which is a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
<td>the name of the property to get</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>a location to return the value</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-set-property"></a><h3>gtk_container_child_set_property ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_set_property    (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
                                                         <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<p>
Sets a child property for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a widget which is a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
<td>the name of the property to set</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>the value to set the property to</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-get-valist"></a><h3>gtk_container_child_get_valist ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_get_valist      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>
Gets the values of one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a widget which is a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
<td>the name of the first property to get</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
<td>return location for the first property, followed
optionally by more name/return location pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-set-valist"></a><h3>gtk_container_child_set_valist ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_set_valist      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>
Sets one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a widget which is a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
<td>the name of the first property to set</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
<td>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
with <em class="parameter"><code>first_prop_name</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-forall"></a><h3>gtk_container_forall ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_forall                (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
<p>
Invokes <em class="parameter"><code>callback</code></em> on each child of <em class="parameter"><code>container</code></em>, including children
that are considered "internal" (implementation details of the
container). "Internal" children generally weren't added by the user
of the container, but were added by the container implementation
itself.  Most applications should use <a class="link" href="gtk3-GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()"><code class="function">gtk_container_foreach()</code></a>,
rather than <a class="link" href="gtk3-GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>a callback. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
<td>callback user data</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-border-width"></a><h3>gtk_container_get_border_width ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_container_get_border_width      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Retrieves the border width of the container. See
<a class="link" href="gtk3-GtkContainer.html#gtk-container-set-border-width" title="gtk_container_set_border_width ()"><code class="function">gtk_container_set_border_width()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the current border width</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-border-width"></a><h3>gtk_container_set_border_width ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_border_width      (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> border_width</code></em>);</pre>
<p>
Sets the border width of the container.
</p>
<p>
The border width of a container is the amount of space to leave
around the outside of the container. The only exception to this is
<a class="link" href="gtk3-GtkWindow.html#GtkWindow" title="GtkWindow"><span class="type">GtkWindow</span></a>; because toplevel windows can't leave space outside,
they leave the space inside. The border is added on all sides of
the container. To add space to only one side, one approach is to
create a <a class="link" href="gtk3-GtkAlignment.html#GtkAlignment" title="struct GtkAlignment"><span class="type">GtkAlignment</span></a> widget, call <a class="link" href="gtk3-GtkWidget.html#gtk-widget-set-size-request" title="gtk_widget_set_size_request ()"><code class="function">gtk_widget_set_size_request()</code></a>
to give it a size, and place it on the side of the container as
a spacer.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>border_width</code></em> :</span></p></td>
<td>amount of blank space to leave <span class="emphasis"><em>outside</em></span>
the container. Valid values are in the range 0-65535 pixels.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-propagate-draw"></a><h3>gtk_container_propagate_draw ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_propagate_draw        (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code><a href="../cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
<p>
When a container receives a call to the draw function, it must send
synthetic <span class="type">"draw"</span> calls to all children that don't have their
own <a href="../gdk3/gdk3-Windows.html#GdkWindow"><span class="type">GdkWindows</span></a>. This function provides a convenient way of doing this.
A container, when it receives a call to its <span class="type">"draw"</span> function,
calls <a class="link" href="gtk3-GtkContainer.html#gtk-container-propagate-draw" title="gtk_container_propagate_draw ()"><code class="function">gtk_container_propagate_draw()</code></a> once for each child, passing in
the <em class="parameter"><code>cr</code></em> the container received.
</p>
<p>
<a class="link" href="gtk3-GtkContainer.html#gtk-container-propagate-draw" title="gtk_container_propagate_draw ()"><code class="function">gtk_container_propagate_draw()</code></a> takes care of translating the origin of <em class="parameter"><code>cr</code></em>,
and deciding whether the draw needs to be sent to the child. It is a
convenient and optimized way of getting the same effect as calling
<a class="link" href="gtk3-GtkWidget.html#gtk-widget-draw" title="gtk_widget_draw ()"><code class="function">gtk_widget_draw()</code></a> on the child directly.
</p>
<p>
In most cases, a container can simply either inherit the
<span class="type">"draw"</span> implementation from <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>, or do some drawing
and then chain to the ::draw implementation from <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>a child of <em class="parameter"><code>container</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cr</code></em> :</span></p></td>
<td>Cairo context as passed to the container. If you want to use <em class="parameter"><code>cr</code></em>
in container's draw function, consider using <a href="../cairo/cairo-cairo-t.html#cairo-save"><code class="function">cairo_save()</code></a> and
<a href="../cairo/cairo-cairo-t.html#cairo-restore"><code class="function">cairo_restore()</code></a> before calling this function.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-chain"></a><h3>gtk_container_get_focus_chain ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_container_get_focus_chain       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **focusable_widgets</code></em>);</pre>
<p>
Retrieves the focus chain of the container, if one has been
set explicitly. If no focus chain has been explicitly
set, GTK+ computes the focus chain based on the positions
of the children. In that case, GTK+ stores <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in
<em class="parameter"><code>focusable_widgets</code></em> and returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>focusable_widgets</code></em> :</span></p></td>
<td>location
to store the focus chain of the
container, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. You should free this list
using <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> when you are done with it, however
no additional reference count is added to the
individual widgets in the focus chain. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the focus chain of the container
has been set explicitly.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-chain"></a><h3>gtk_container_set_focus_chain ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_focus_chain       (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *focusable_widgets</code></em>);</pre>
<p>
Sets a focus chain, overriding the one computed automatically by GTK+.
</p>
<p>
In principle each widget in the chain should be a descendant of the
container, but this is not enforced by this method, since it's allowed
to set the focus chain before you pack the widgets, or have a widget
in the chain that isn't always packed. The necessary checks are done
when the focus chain is actually traversed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>focusable_widgets</code></em> :</span></p></td>
<td>the new focus chain. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-unset-focus-chain"></a><h3>gtk_container_unset_focus_chain ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_unset_focus_chain     (<em class="parameter"><code><a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>
Removes a focus chain explicitly set with <a class="link" href="gtk3-GtkContainer.html#gtk-container-set-focus-chain" title="gtk_container_set_focus_chain ()"><code class="function">gtk_container_set_focus_chain()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-class-find-child-property"></a><h3>gtk_container_class_find_child_property ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *        gtk_container_class_find_child_property
                                                        (<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
<p>
Finds a child property of a container class by name.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>cclass</code></em> :</span></p></td>
<td>a <span class="type">GtkContainerClass</span>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GtkContainerClass]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
<td>the name of the child property to find</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the child property or
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>class</code></em> has no child property with that name. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-class-install-child-property"></a><h3>gtk_container_class_install_child_property ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_class_install_child_property
                                                        (<em class="parameter"><code><span class="type">GtkContainerClass</span> *cclass</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);</pre>
<p>
Installs a child property on a container class.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>cclass</code></em> :</span></p></td>
<td>a <span class="type">GtkContainerClass</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>property_id</code></em> :</span></p></td>
<td>the id for the property</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
<td>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-class-list-child-properties"></a><h3>gtk_container_class_list_child_properties ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **       gtk_container_class_list_child_properties
                                                        (<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);</pre>
<p>
Returns all child properties of a container class.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>cclass</code></em> :</span></p></td>
<td>a <span class="type">GtkContainerClass</span>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GtkContainerClass]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_properties</code></em> :</span></p></td>
<td>location to return the number of child properties found</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a newly
allocated <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>*.  The
array must be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-class-handle-border-width"></a><h3>gtk_container_class_handle_border_width ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_class_handle_border_width
                                                        (<em class="parameter"><code><span class="type">GtkContainerClass</span> *klass</code></em>);</pre>
<p>
Modifies a subclass of <span class="type">GtkContainerClass</span> to automatically add and
remove the border-width setting on GtkContainer.  This allows the
subclass to ignore the border width in its size request and
allocate methods. The intent is for a subclass to invoke this
in its class_init function.
</p>
<p>
<a class="link" href="gtk3-GtkContainer.html#gtk-container-class-handle-border-width" title="gtk_container_class_handle_border_width ()"><code class="function">gtk_container_class_handle_border_width()</code></a> is necessary because it
would break API too badly to make this behavior the default. So
subclasses must "opt in" to the parent class handling border_width
for them.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
<td>the class struct of a <a class="link" href="gtk3-GtkContainer.html#GtkContainer" title="struct GtkContainer"><span class="type">GtkContainer</span></a> subclass</td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>